We provide you with the following types of shareable verification links:

• Unilinks
• Permalinks

Use unilinks

Unilinks are created automatically upon saving the verification level and are unique for each level; you can share this link with multiple applicants. To pass verification, applicants will have to verify their email first. Each email can be used to create only one applicant per level.

To create a unilink:

1. In the Dashboard, set up a verification level to be used when your applicants open the link.
2. Open the level and in the Verification links section, and then choose Copy or use the QR code.
3. Share the link with your applicants to verify their identity without using code.

Under the QR-code section, you can see how many times the link was used to verify applicants. This number is calculated based on the number of email addresses used for verification via a specific link.

📘

Note

• If applicants complete email verification but do not complete document verification and re-open the same link on the same device and in the same browser, email verification will be skipped.
• If the applicant session expires (currently 30 min) after completing email verification, the applicant will have to repeat email verification.
• If applicants start the session using a link and then create a personal mobile link that expires, they will be taken back to the email verification step.

You can generate a new unilink at any moment by clicking Generate new.

❗️

Warning

When you generate a new link, the previous one becomes invalid and cannot be used for verification.

Use permalinks

Permalinks are created manually by you in cases you have not yet integrated with Sumsub, but still want to let your applicants pass verification.

You can create two types of permalinks:

• A permalink based on the external applicant ID
• A set of independent permalinks

📘

Note

Unlike unilinks, each permalink can be used for only one verification (one applicant). Once the verification is completed, the same permalink cannot be reused.

Create permalink in the Dashboard

To create a permalink:

1. In the Dashboard, open the Integrations page and choose between Individuals and Companies.
2. Find a verification level for which you want to generate a permalink.
   1. Click WebSDK permalinks on the right-hand side of the level record, or
   2. Open the level and click Verification links to create it from inside the level.
3. Choose whether you want to create a permalink for a specific user or generate a set of permalinks:
   1. For a permalink based on the external user ID, provide an External user ID (or use the randomly generated one) and set other fields such as Language, Link validity, Customization, and SDK translations. Click Generate link to create a permalink.
   2. For a set of independent permalinks, specify the number of links and set the same fields as above. Click Generate multiple links to create a set of permalinks.
4. Copy the generated link(s).

📘

Note

Applicants who pass identity verification using permalinks will be associated with your API key, allowing you to obtain the applicant data via the Sumsub API or using the Dashboard.

Create permalink with Sumsub API

To create a permalink via the API, use this API method.

curl -X POST \  'https://api.sumsub.com/resources/sdkIntegrations/levels/basic-kyc-level/websdkLink?ttlInSecs=1800&externalUserId=johnDoeId&lang=en' \
     -H 'Accept: application/json' \
     -H 'Content-Type: application/json' \
     -d '{ }'

Response

A sharable URL is returned.

{
    "url": "https://api.sumsub.com/idensic/l/#/lPDnIKwzmxPfDohk"
}